Registering the Name of Your Software17

After your software has established a connection to a video output component, you can register its name with the instance of that component by calling the QTVideoOutputSetClientName function. The name can then be used by QTVideoOutputGetCurrentClientName to specify which software has exclusive access to the video output device controlled by the component.

Although several applications or other software can connect to a video output component at the same time, only one of them at a time can have access to the video output device controlled by the component. Use QTVideoOutputBegin to gain exclusive access to the video output device and QTVideoOutputEnd to relinquish exclusive access when your software has finished using the device.

To get the name of the application or other software that is registered with an instance of a video output component, call QTVideoOutputGetClientName .

QTVideoOutputGetClientName

You can use the QTVideoOutputGetClientName function to get the name of the application or other software that is registered with an instance of a video output component.



 
pascal ComponentResult QTVideoOutputGetClientName (

                     QTVideoOutputComponent vo, 

                     Str255 str);

vo: Specifies the instance of a video output component for the request. Your software obtains this reference when it calls the Component Manager's OpenComponent or OpenDefaultComponent function.
str: The name of the application or other software that is registered with the component instance.

QTVideoOutputSetClientName

You use the QTVideoOutputSetClientName function to register the name of an application or other software with an instance of a video output component.



 
pascal ComponentResult QTVideoOutputSetClientName (

                     QTVideoOutputComponent vo, 

                     ConstStr255Param str);

vo: Specifies the instance of a video output component for the request. Your software obtains this reference when it calls the Component Manager's OpenComponent or OpenDefaultComponent function.
str: The name of the application or other software to be registered.

DISCUSSION

The name you specify with the QTVideoOutputSetClientName function can later be used by QTVideoOutputGetCurrentClientName to specify which software has exclusive access to the video output device controlled by the component.